<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<!-- Copyright 1997 The Open Group, All Rights Reserved -->
<title>uncompress</title>
</head><body bgcolor=white>
<center>
<font size=2>
The Single UNIX &reg; Specification, Version 2<br>
Copyright &copy; 1997 The Open Group

</font></center><hr size=2 noshade>
<h4><a name = "tag_001_014_2505">&nbsp;</a>NAME</h4><blockquote>
uncompress - expand compressed data
</blockquote><h4><a name = "tag_001_014_2506">&nbsp;</a>SYNOPSIS</h4><blockquote>
<pre><code>

uncompress <b>[</b>-cfv<b>][</b><i>file</i>...<b>]
</b></code>
</pre>
</blockquote><h4><a name = "tag_001_014_2507">&nbsp;</a>DESCRIPTION</h4><blockquote>
The
<i>uncompress</i>
utility will restore files to their original state after they have been
compressed using the
<i><a href="compress.html">compress</a></i>
utility.
If no files are specified, the standard input will be uncompressed to the
standard output.  If the invoking process has appropriate privileges, the
ownership, modes, access time, and modification time of the original file are
preserved.
<p>
This utility supports the uncompressing of any files produced by the
<i><a href="compress.html">compress</a></i>
utility on the same implementation.
For files produced by
<i><a href="compress.html">compress</a></i>
on other systems,
<i>uncompress</i>
supports 9- to 14-bit compression (see
<i><a href="compress.html">compress</a></i>
<b>-b</b>);
it is implementation-dependent whether values of
<b>-b</b>
greater than 14 are supported.
</blockquote><h4><a name = "tag_001_014_2508">&nbsp;</a>OPTIONS</h4><blockquote>
The
<i>uncompress</i>
utility supports the <b>XBD</b> specification, <a href="../xbd/utilconv.html#usg"><b>Utility Syntax Guidelines</b>&nbsp;</a> .
<p>
The following options are supported:
<dl compact>

<dt><b>-c</b>
<dd>Write to standard output; no files will be changed.

<dt><b>-f</b>
<dd>Do not prompt for overwriting files.
Except when run in the background, if
<b>-f</b>
is not given the user will be prompted as to whether an existing
file should be overwritten.
If the standard input is not a terminal and
<b>-f</b>
is not given,
<i>uncompress</i>
will write a diagnostic message to standard error and exit
with a status greater than zero.

<dt><b>-v</b>
<dd>Write messages to standard error concerning the expansion of each file.

</dl>
</blockquote><h4><a name = "tag_001_014_2509">&nbsp;</a>OPERANDS</h4><blockquote>
The following operand is supported:
<dl compact>

<dt><i>file</i><dd>A pathname of a file.
If
<i>file</i>
already has the
.Z
suffix specified,
it will be used as the input file and the output file will be named
<i>file</i>
with the
.Z
suffix removed.
Otherwise,
<i>file</i>
will be used as the name of the output file and
<i>file</i>
with the
.Z
suffix appended will be used as the input file.

</dl>
</blockquote><h4><a name = "tag_001_014_2510">&nbsp;</a>STDIN</h4><blockquote>
The standard input will be used only if no
<i>file</i>
operands are specified, or if a
<i>file</i>
operand is "-".
</blockquote><h4><a name = "tag_001_014_2511">&nbsp;</a>INPUT FILES</h4><blockquote>
Input files are in the format produced by the
<i><a href="compress.html">compress</a></i>
utility.
</blockquote><h4><a name = "tag_001_014_2512">&nbsp;</a>ENVIRONMENT VARIABLES</h4><blockquote>
The following environment variables affect the execution of
<i>uncompress</i>:
<dl compact>

<dt><i>LANG</i><dd>Provide a default value for the internationalisation variables
that are unset or null.
If
<i>LANG</i>
is unset or null, the corresponding value from the
implementation-dependent default locale will be used.
If any of the internationalisation variables contains an invalid setting, the
utility will behave as if none of the variables had been defined.

<dt><i>LC_ALL</i><dd>
If set to a non-empty string value,
override the values of all the other internationalisation variables.

<dt><i>LC_CTYPE</i><dd>
Determine the
locale for the interpretation of sequences of bytes of text data as
characters (for example, single- as opposed to multi-byte characters
in arguments).

<dt><i>LC_MESSAGES</i><dd>
Determine the locale that should be used to affect
the format and contents of diagnostic
messages written to standard error.

<dt><i>NLSPATH</i><dd>
Determine the location of message catalogues
for the processing of
<i>LC_MESSAGES .
</i>
</dl>
</blockquote><h4><a name = "tag_001_014_2513">&nbsp;</a>ASYNCHRONOUS EVENTS</h4><blockquote>
Default.
</blockquote><h4><a name = "tag_001_014_2514">&nbsp;</a>STDOUT</h4><blockquote>
When there are no file operands or the
<b>-c</b>
option is specified,
the uncompressed output will be written to standard output.
</blockquote><h4><a name = "tag_001_014_2515">&nbsp;</a>STDERR</h4><blockquote>
Prompts will be written to the standard error output under the conditions
specified in the DESCRIPTION and OPTIONS sections.
The prompts will contain the
<i>file</i>
pathname, but their format is otherwise unspecified.
Otherwise, the standard error output will be
used only for diagnostic messages.
</blockquote><h4><a name = "tag_001_014_2516">&nbsp;</a>OUTPUT FILES</h4><blockquote>
Output files are the same as the respective input files to
<i><a href="compress.html">compress</a></i>.
</blockquote><h4><a name = "tag_001_014_2517">&nbsp;</a>EXTENDED DESCRIPTION</h4><blockquote>
None.
</blockquote><h4><a name = "tag_001_014_2518">&nbsp;</a>EXIT STATUS</h4><blockquote>
The following exit values are returned:
<dl compact>

<dt>0<dd>Successful completion.

<dt>&gt;0<dd>An error occurred.

</dl>
</blockquote><h4><a name = "tag_001_014_2519">&nbsp;</a>CONSEQUENCES OF ERRORS</h4><blockquote>
The input file will remain unmodified.
</blockquote><h4><a name = "tag_001_014_2520">&nbsp;</a>APPLICATION USAGE</h4><blockquote>
The limit of 14 on the
<i><a href="compress.html">compress</a></i>
<b>-b</b>&nbsp;<i>bits</i>
argument is to achieve portability to all systems
(within the restrictions imposed by the lack of an explicit published
file format).
Some systems based on 16-bit architectures cannot support
15- or 16-bit uncompression.
</blockquote><h4><a name = "tag_001_014_2521">&nbsp;</a>EXAMPLES</h4><blockquote>
None.
</blockquote><h4><a name = "tag_001_014_2522">&nbsp;</a>FUTURE DIRECTIONS</h4><blockquote>
None.
</blockquote><h4><a name = "tag_001_014_2523">&nbsp;</a>SEE ALSO</h4><blockquote>
<i><a href="compress.html">compress</a></i>,
<i><a href="unpack.html">unpack</a></i>,
<i><a href="zcat.html">zcat</a></i>.
</blockquote><hr size=2 noshade>
<center><font size=2>
UNIX &reg; is a registered Trademark of The Open Group.<br>
Copyright &copy; 1997 The Open Group
<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]

</font></center><hr size=2 noshade>
</body></html>
